home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_swirly.idb / usr / freeware / lib / swirly / README.z / README
Encoding:
Text File  |  1999-01-26  |  3.0 KB  |  78 lines
  1. SWIRLY README
  2.  
  3. Swirly is a neato SGI screen saver that uses color map animation to make 
  4. complex swirly patterns. It creates a number of nodes at random locations and then creates waves, spokes, and spirals coming from each node. The combinations
  5. of the patterns from each node creates lava-lamp like effects.
  6.  
  7. To run swirly, use
  8. swirly [-s] [-c n] [-a n] [-r n] [#]
  9.  
  10. options:
  11.     -s    Makes swirly run screen saver mode, i.e. full screen, no window
  12.             border.
  13.     #    Specifies the number of nodes to use. The default is 4.
  14.     -c n    Make a color between n base colors (default 5)
  15.     -a t    animation speed (0 = fastest, 10 = normal)
  16.     -r t    Processing speed, slower means more time for other processes (0 = fastest <default>)
  17.  
  18. For Irix 4.x or 5.x systems, use the swirly.irix4 executable instead.
  19.  
  20. To use Swirly as a screen saver, type:
  21. haven swirly -s &
  22.  
  23. Haven is the screen saver control program and will call swirly after 10 minutes
  24. of keyboard and mouse inactivity. You can add a number after the '-s' option
  25. to have more nodes than the default 4. Add this line to your .sgisession or
  26. .login to always use it as a screen saver.
  27.  
  28. Or you can add Swirly to the list of screen saver control panel on the desktop 
  29. tool chest (Desktop->Customize->Screen Savers) by creating a file called swirly
  30. in /usr/lib/X11/savers/defaults/ (you must be root) with the following 
  31. contents:
  32.  
  33. swirly.ssTitle: Swirly
  34. swirly.ssDso: glsavers.so
  35. swirly.ssKey: swirly
  36. swirly.ssCommand: /usr/sbin/haven -n /usr/local/bin/swirly -s > /dev/null 2>&1&
  37. swirly.ssCheckRead: /usr/lib/X11/savers/modules/haven.so
  38. !!swirly.ssCheckWrite:
  39. swirly.ssCheckExe: /usr/sbin/haven,/usr/local/bin/swirly
  40. *swirly.label.labelString:   Swirly
  41. *swirly.message.labelString: \nScreen locking\nis unavailable for\nGL screen savers.
  42.  
  43. This file is included in the tar distribution as 'swirly.ss'. Just change the 
  44. path name to Swirly (/usr/local/bin/swirly) to where ever you have it, and 
  45. move the file to /usr/lib/X11/savers/defaults/. Thanks to David Cortesi 
  46. (http://reality.sgi.com/employees/cortesi_wpd/) for this info.
  47.  
  48.  
  49. Known problems
  50.  
  51. Swirly works by doing GL color map animation, and this will animate the
  52. palettes of other GL rendered windows since there is only on GL color map. This
  53. will show up in programs like ical, gr_osview, gr_top, etc. In future versions
  54. I'll make it so that it saves the color map and restores it when it's done.
  55.  
  56.  
  57. Source Code
  58.  
  59. I've included the source code for those that are interested in making
  60. modifications since I've had many requests to this effect. If you make
  61. any improvements (converting to OpenGL, speed ups, new features) let
  62. me know and I can include them in the distribution.
  63.  
  64. You should be able to compile with the included makefile on any IRIX
  65. machine that has IrisGL libraries by typing 'make opt' for an
  66. optimized version or 'make dbg' for a debug version.
  67.  
  68. Please do not distribute the source code or any programs derived from
  69. it without my permission.
  70.  
  71.  
  72. Check http://os.sri.com/people/nat/swirly.html for updates
  73.  
  74. Have fun!
  75.  
  76. Nat Bletter
  77. nat@ai.sri.com
  78.